ФрагментДокументаDOM.ВставитьПеред (DOMDocumentFragment.InsertBefore)
ФрагментДокументаDOM (DOMDocumentFragment)
ВставитьПеред (InsertBefore)
Доступен, начиная с версии 8.1.
Синтаксис:
ВставитьПеред(<НовыйУзел>, <Узел>)Параметры:
<НовыйУзел> (обязательный)
Вставляемый узел DOM.
<Узел> (обязательный)
Узел, перед которым необходимо вставить узел, заданный в параметре <НовыйУзел>.
Если параметр не задан, то узел добавляется к концу списка дочерних узлов.
Возвращаемое значение:
Тип: АтрибутDOM, ДокументDOM, ЭлементDOM, ОпределениеТипаДокументаDOM, НотацияDOM, СущностьDOM, ФрагментДокументаDOM, ТекстDOM, КомментарийDOM, СекцияCDATADOM, ИнструкцияОбработкиDOM, СсылкаНаСущностьDOM, ПространствоИменXPath.Описание:
Вставляет узел в список дочерних перед существующим дочерним узлом, заданным параметром <Узел>.
Если вставляемый узел является узлом ФрагментДокумента, то все его дочерние узлы будут вставлены перед узлом, заданным параметром <Узел>, в том же порядке. Если узел, заданный параметром <НовыйУзел>, уже содержится в дереве документа, то он сначала удаляется из дочерних узлов прежнего родителя и вставляется в список дочерних узлов нового родителя.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Причины вызова исключения:- данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного или узел добавляется сам в себя или данный узел Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
- добавляемый узел был создан документом отличным от создавшего данный узел;
- данный узел в режиме Только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
- узел, перед которым осуществляется вставка, не найден.
Использование в версии:
Доступен, начиная с версии 8.1.